Markdown Links to Wikilink Converter
GitHub Repo: wchorski/wikilink_markdownlink_conversion
A NodeJS tool that converts markdown links to wikilinks and vice versa. Helpful for note taking apps like Obsidian.md
I'll be using Markdown Wikilink Example Note as an example to test this script.
Features
- Leverage Javascript to consistently convert links via
encodeURIComponent()&decodeURIComponent() - Automatically handle non conventional URLs that may include special characters like
(,) - Leave external links as markdown links.
- Run on single file, selected directory, or whole vault
- Support for alias on wikilinks or markdown links
Note apps like Obsidian.md do not allow characters # ^ [ ] | in their filename. This converter assumes you do not use any of these characters in your filenames
Conversion Examples
Wikilinks to markdown links is the most stable (because it was simple logic)
Wikilinks -> Markdown Links
- Markdown Links to Wikilink Converter
- Coder Advice - Working With 'Idea Men'
- CSS
- Example * & + = ;
- Example @ file
- Example File with open ( parentheses
after conversion
- [Markdown Links to Wikilink Converter](developer/Projects📐/Markdown%20Links%20to%20Wikilink%20Converter.md)
- [Coder Advice - Working With 'Idea Men'](developer/Advice/Coder%20Advice%20-%20Working%20With%20'Idea%20Men'.md)
- [CSS](developer/CSS/CSS.md)
- [Example * & + = ;](developer/Projects📐/Markdown%20Wikilink%20Examples/Example%20*%20&%20+%20=%20;.md)
- [Example @ file](developer/Projects📐/Markdown%20Wikilink%20Examples/Example%20@%20file.md)
- [Example File with open ( parentheses](developer/Projects📐/Markdown%20Wikilink%20Examples/Example%20File%20with%20open%20(%20parentheses.md)
Markdown Links -> Wikilinks
Wikilinks to markdown links is still needs better conversion logic, it just simply converts any space in the url to %20. Hoping to dig into this more later, but should be good for most cases since Obsidian.md forces you to create URL friendly filenames. The biggest gotcha right now is filenames that contain a%, which I'll make a big assumption that your vault's filenames won't contain that.
- [Markdown Links to Wikilink Converter](developer/Projects📐/Markdown%20Links%20to%20Wikilink%20Converter.md)
- [Coder Advice - Working With 'Idea Men'](developer/Advice/Coder%20Advice%20-%20Working%20With%20'Idea%20Men'.md)
- [CSS](developer/CSS/CSS.md)
- [Example * & + = ;](developer/Projects📐/Markdown%20Wikilink%20Examples/Example%20*%20&%20+%20=%20;.md)
- [Example @ file](developer/Projects📐/Markdown%20Wikilink%20Examples/Example%20@%20file.md)
- [Example File with open ( parentheses](developer/Projects📐/Markdown%20Wikilink%20Examples/Example%20File%20with%20open%20(%20parentheses.md)
after conversion
- Markdown Links to Wikilink Converter
- Coder Advice - Working With 'Idea Men'
- CSS
- Example * & + = ;
- Example @ file
- Example File with open ( parentheses
Development
Run on a file or directory. For now this is the quick and dirty way of running this app on a file or folder
findUrlsAndWriteToFile('./exampleFolder/note.md', 'wikilink');
# or
readDirectory('./exampleFolder', 'markdownLink')
Run Typescript with Node
npx ts-node app.ts